Prevents the Memory Manager from purging the base address for an offscreen pixel image.

void NoPurgePixels (
    PixMapHandle pm
);

Parameter descriptions

pm

A handle to an offscreen pixel map.

DISCUSSION

The NoPurgePixels function marks the base address for an offscreen pixel image as unpurgeable.

To get a handle to an offscreen pixel map, use the GetGWorldPixMap function. Then supply this handle for the pm parameter of NoPurgePixels.

SPECIAL CONSIDERATIONS

The NoPurgePixels function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)